.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "CART" 6 "2022-06-15" "5.0.0" "SlackBuilds.org"
.SH NAME
cart \- convert raw Atari 8-bit ROM images to Atari800 CART files.
.\" RST source for cart(1) man page. Convert with:
.
.\" rst2man.py cart.rst > cart.6
.
.\" rst2man.py comes from the SBo development/docutils package.
.
.SH SYNOPSIS
.sp
cart \fIromfile\fP \fIcartfile\fP \fIcarttype\fP
.sp
cart \fB\-l\fP
.sp
cart \fB\-p\fP \fIromfile\fP
.SH DESCRIPTION
.sp
\fBcart\fP creates an Atari800 CART image file from a raw Atari 8\-bit ROM
image file by adding a 16\-byte \fBCART\fP header.
.sp
The \fIromfile\fP is a file containing a raw Atari 8\-bit ROM image
dump. It must be of the correct size for the \fIcarttype\fP argument
(e.g. for type 1, "Standard 8KB cartridge", the file must be exactly
8192 bytes).
.sp
Output is written to \fIcartfile\fP\&. This must be a different filename
from \fIromfile\fP (in\-place conversion is not supported). \fIcartfile\fP will
be exactly 16 bytes longer than \fIromfile\fP (e.g. for type 1, it will be
8208 bytes).
.sp
The \fIcarttype\fP argument is numeric, one of the supported types. The
list can be viewed with \fBcart \-l\fP\&. If you\(aqre not sure of the correct
type for a given ROM, you can narrow it down by running \fBcart \-p\fP
\fIromfile\fP, which will show all the possible types that match the size
of the ROM.
.sp
There is no corresponding tool to convert a CART image back to a raw
ROM file, but this can be done with e.g. \fBdd\fP(1):
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
dd if=image.cart of=image.raw bs=1 skip=16
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
\&...or \fBhead\fP(1) and \fBcat\fP(1):
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
cat image.cart | ( head \-c16 >/dev/null ; cat ) > image.raw
.ft P
.fi
.UNINDENT
.UNINDENT
.SH OPTIONS
.INDENT 0.0
.TP
.B  \-l
Show the complete list of supported cartridge types.
.UNINDENT
.INDENT 0.0
.TP
.B \-p \fIromfile\fP
Show the list of cartridge types that match the size of \fIromfile\fP\&.
.UNINDENT
.SH COPYRIGHT
.sp
See the file /usr/doc/atari800\-5.0.0/COPYING for license information.
.SH AUTHORS
.sp
\fBcart\fP is part of the \fBatari800\fP(6) distribution. See
/usr/doc/atari800\-5.0.0/CREDITS for the list of authors.
.sp
This man page written for the SlackBuilds.org project
by B. Watson, and is licensed under the WTFPL.
.SH SEE ALSO
.sp
\fBatari800\fP(6)
.INDENT 0.0
.TP
.B Full documentation for the CART file format:
/usr/doc/atari800\-5.0.0/cart.txt
.TP
.B The \fBatari800\fP website:
\fI\%https://atari800.github.io/\fP
.UNINDENT
.\" Generated by docutils manpage writer.
.
